home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / bfiremtd.zip / BACKFIRE.DOC next >
Text File  |  1992-09-06  |  67KB  |  1,566 lines
  1.  
  2.        
  3.        
  4.        ╔═╦═══════╗
  5.          ║       ╚╗
  6.          ║        ║  ╔════════╗  ╔════════╗    ╦      ╦
  7.          ║       ╔╝  ║        ║  ║        ║    ║   ╔══╝
  8.          ╠═══════╣   ╠════════╣  ║        ╩    ║  ╔╝
  9.          ║       ╚╗  ║        ║  ║             ╠══╣
  10.          ║        ║  ║        ║  ║        ╦    ║  ╚╗
  11.          ║       ╔╝  ║        ║  ║        ║    ║   ╚╗
  12.        ╚═╩═══════╝   ╩        ╩  ╚════════╝    ╩    ╚══╝
  13.        
  14.                    ╔══╦════╗   ╔═══╦═══╗    ╔═╦═════╗     ╔═╦═════╗
  15.                       ║            ║          ║     ╚╗      ║
  16.                       ╠═══╣        ║          ║     ╔╝      ║
  17.                       ║            ║          ╠═════╣       ╠═════╣
  18.                       ║            ║          ║     ╚╗      ║
  19.                       ║            ║          ║      ║      ║
  20.                       ╩        ╚═══╩═══╝      ╩      ╩    ╚═╩═════╝
  21.                         Callback Verification for GAP 6.x
  22.        
  23.        
  24.                                  BackFire Version 3.05
  25.                           Copyright 1991,1992 Stephen L. Cox
  26.                                    All Rights Reserved
  27.        
  28.        
  29.                                   REGISTERED VERSION
  30.                       !! MAY NOT BE DISTRIBUTED FOR ANY REASON !!        
  31.        
  32.        
  33.        
  34.        
  35.        Welcome  to  BackFire, the  Callback  Verification  system  designed
  36.        exclusively for GAP 6.x systems.
  37.        
  38.        BackFire offers you  unparalleled reliability and flexibility in the
  39.        important task of verification your BBS callers.
  40.        
  41.        BackFire was designed with SAFETY and RELIABILITY in mind and a great
  42.        deal of thought has gone into its design.
  43.        
  44.        Although extremely  powerful, BackFire  is easy to install, and once
  45.        installed it seldom needs further attention.
  46.        
  47.        BackFire  is  tightly  integrated  with  GAP 6.x. Data files, screen
  48.        files  and  executable  files  use  directory  structures  that  are
  49.        already  in  place  and  in  use  by GAP. No special directories are
  50.        required and there are NO modem reconfigurations necessary.
  51.        
  52.        I believe you  will find BackFire to be an indispensable addition to
  53.        your BBS system.  I hope you enjoy using it as much as I've  enjoyed
  54.        bringing it to you.
  55.        
  56.        Steve Cox        
  57.        THE PRELIMINARIES:
  58.        
  59.        [[[ Limited License ]]]
  60.        
  61.        The  TEST  DRIVE  versions  of  BackFire  are copyrighted commercial
  62.        software but may  be freely distributed  in unmodified form  and all
  63.        copyright notices must remain intact.
  64.        
  65.        The REGISTERED versions of BackFire are copyrighted commercial
  66.        software and may NOT be distributed in any way.  
  67.        
  68.         BackFire (tm) Version 3.05
  69.         Copyright 1991,1992 by Stephen L. Cox
  70.         All Rights Reserved
  71.        
  72.         Distributed by:
  73.                Live Systems
  74.                3800 Old Cheney Road
  75.                Suite 101-133
  76.                Lincoln, Ne.
  77.                 68516
  78.        
  79.          With registration you receive:
  80.          Full registered copy of the latest version of BackFire
  81.          Program support
  82.          Updates via Flite-Line Download
  83.        
  84.        [[[ Warranty ]]]
  85.         
  86.        The BackFire system is provided "AS IS" without warranty of any kind
  87.        either expressed or implied. The  entire risk as to the  results and
  88.        performance of this program is assumed by you.  The author does  not
  89.        warrant, guarantee  or make  any representations  regarding the  use
  90.        of,  results  of,  merchantability  or  fitness  for any use of this
  91.        product and you rely on this program and results solely at your  own
  92.        risk.   Steve  Cox  and  Live  Systems  will  not  be liable for any
  93.        damages, including but not limited to system damage, loss of profit,
  94.        lost  savings,  or  any  other  incidental, consequential or special
  95.        damages  of  any  nature  whatsoever  resulting  from the use of, or
  96.        inability to use this product.
  97.        
  98.        
  99.        *THE INSTALLATION OF BACKFIRE ON YOUR SYSTEM CONSTITUTES ACCEPTANCE
  100.        OF THE ABOVE TERMS *
  101.                
  102.        
  103.        
  104.        
  105.        [[ ACKNOWLEDGMENTS ]]
  106.        
  107.          Many  people  have  helped  with  the  development and testing of
  108.          BackFire and my sincere thanks go out to them.
  109.        
  110.          There are four persons who have gone repeatedly above and  beyond
  111.          the call during development of this product.  They are:
  112.        
  113.          Farrell Reis, sysop of the Star BBS in Sacramento CA
  114.          Ron Alspaugh, sysop of The Exchange BBS in Charlotte NC
  115.          Bob Gibson, sysop of Lifeline BBS in Los Angeles, CA.
  116.          Ira Lichtenstein, sysop of SING SING SING in Ossining, NY.
  117.        
  118.          My  special  thanks  go  to  these  four  dedicated testers and my
  119.          appreciation for a job well done.  Without you this project  would
  120.          probably never have happened.
  121.        
  122.        
  123.          GAP 6.x Copyright by GAP Development Company
  124.        
  125.          BackFire 3.05 is written in  Microsoft 'C' V 7.0 and  Microsoft
  126.          Macro Assembler V 5.1.
  127.        
  128.         Portions of BackFire utilize the Ctree File Handler, copyright 1988
  129.          by Faircom and  are the proprietary  and confidential property  of
  130.          Faircom Inc., Columbia, Mo.        
  131.        
  132.        
  133.        [[ WHAT CAN BACKFIRE DO FOR YOU ]]
  134.        
  135.        Main features of BackFire are:
  136.        
  137.        Support of COM1 thru COM35  on virtually any interrupt and  i/o base
  138.        address  that  is  available  in  your  system.   We  feature   full
  139.        detection  and  compensation  for  in-place  fossil  drivers,   full
  140.        support of 16550 UART  in FIFO mode and  full locked DTE support  at
  141.        baud rates to 115k.
  142.        
  143.        BackFire works without  changing  ANY setup changes to your current
  144.        modem configuration.
  145.        
  146.        Support  for  up  to  5   different  upgrade  levels  is   supported
  147.        automatically if you choose  to use them.   You may set from  1 to 5
  148.        levels  that  are  permitted  INTO  BackFire  and five corresponding
  149.        levels  to  which  the  user   will  be  upgraded  upon   successful
  150.        completion of the call back process.
  151.        
  152.        Full Support for sysop configurable parameters to:
  153.        
  154.        A. Permit or disallow Long Distance Callbacks
  155.        
  156.        B. Permit or disallow Zone Calls (LD calls in your own area code)
  157.        
  158.        C. Configuration of Metropolitan prefixes allowed and disallowed.
  159.        
  160.        D. Call continuation on local calls for the user.
  161.        
  162.        E. Default Profile assignment for LD callers when LD calling is
  163.           disabled.
  164.        
  165.        F. Automatic High Speed checking of duplicate and bogus phone
  166.           numbers.
  167.        
  168.        G. User Call Back History files and logging.
  169.        
  170.        H. Recall detection for failed user callback attempts. (Allows the
  171.           user to run BackFire multiple times until verification is
  172.           achieved then they are locked out of the call back system)
  173.        
  174.        I. Fully configurable Ansi and Ascii display files.
  175.        
  176.        J. Single user and integrated Multi-user versions available.
  177.        
  178.        K. Allows LOCAL mode testing by the Sysop.
  179.        
  180.        L. Auto detection and logging of 900 area codes with automatic
  181.           lockout of users that try this stunt.
  182.        
  183.        These are just a few of the features contained in BackFire today.  I
  184.        think  you  will   find  BackFire  to   be  THE  COMPLETE   callback
  185.        verification you've been looking for.        
  186.        
  187.        
  188.        [[ FILES IN PACKAGE ]]
  189.        
  190.        The file set you downloaded should contain the following files:
  191.        
  192.             BACKFIRE.EXE  -  The BackFire callback verification program
  193.                BFFIG.EXE  -  BackFire configuration program
  194.              BFBUILD.EXE  -  Build the BackFire user files
  195.               BFSYNC.EXE  -  Syncronize the BackFire & GAP User files
  196.             BACKFIRE.DOC  -  This documentation
  197.               LOCALNUM.1  -  Sample LOCAL NUMBERS DIALING list
  198.        
  199.             The following DISPLAY files with both .SCR and .BBS
  200.             extensions are provided:
  201.        
  202.              FAILED.xxx   - Shown if user fails password check
  203.              DUPPED.xxx   - Shown if user duplicates phone #'s
  204.               GETPW.xxx   - Shown when user is prompted for password
  205.              NOLONG.xxx   - Shown to LD callers if LD callback not allowed
  206.             PREPARE.xxx   - Shown to user just prior to beginning callback
  207.             WELCOME.xxx   - First instruction screen shown to user
  208.              PASSED.xxx   - Shown when user passes the password check
  209.                OPEN.xxx   - Opening logo screen, first screen user sees
  210.        
  211.          Each of the files listed above is REQUIRED!  A sample of each
  212.          file has been provided in both Ansi and Ascii format for you to
  213.          work from.
  214.        
  215.          If ANY of the files listed above were not in the package you
  216.          downloaded you should call Flite-Line and download the latest
  217.          package from there.        
  218.                          *** IMPORTANT SPECIAL NOTES ***
  219.        
  220.        In  most  of  the  BackFire documentation  we list  the  location by
  221.        specific directory name for some files.  This assumes that you  used
  222.        the STANDARD GAP 6.0 recommended directory structure.
  223.        
  224.        If you did NOT use  this standard directory naming conventions  then
  225.        whenever  we  reference  the  ?:\GAP\MAIN  directory  we are talking
  226.        about the directory where your  USERS.DAT file is located.   Replace
  227.        any reference to ?:\GAP\MAIN with your appropriate directory name.
  228.        
  229.        Whenever we refer  to the ?:\GAP\GEN  directory we are  referring to
  230.        the directory where  all of your  various GAP 6.x  display files are
  231.        located.  Replace any reference to ?:\GAP\GEN with your  appropriate
  232.        directory name.
  233.        
  234.        BackFire has  the ability through several  different NUMBER FILES to
  235.        make many different types of calls.
  236.        
  237.        You are ONLY REQUIRED to have ONE FILE, LOCALNUM.1 in place!
  238.        
  239.        The rest of the call  types and their supporting files  are ENTIRELY
  240.        OPTIONAL.  You can actually configure BackFire with this one file to
  241.        do LOCAL ONLY  and LOCAL &  LONG DISTANCE callback  verifications in
  242.        just a matter of minutes.  The other types of calls and their  files
  243.        can be created and activated as needed.        
  244.        [[ START UP ]]
  245.        
  246.        To  install  BackFire  for  LOCAL and/or LONG DISTANCE calling ONLY,
  247.        follow these procedures carefully.
  248.        
  249.        1.) Place  BACKFIRE.EXE, BFBUILD.EXE and BFFIG.EXE in DOS SEARCHABLE
  250.            directory.   If your  \GAP directory  is  in  the path,  you may
  251.            place them there.
  252.        
  253.        2.) Unzip  SCREENS.ZIP in  a work  directory and  edit the  .SCR and
  254.            .BBS files to  suit your needs  using THEDRAW or  any other Ansi
  255.            drawing program.  The files with .SCR extensions are ANSI  COLOR
  256.            files and the ones with .BBS are Ascii files.
  257.        
  258.        3.) Copy the EDITED .SCR and .BBS display files to  your \GAP\GEN
  259.            directory. (Or whatever directory you are using for displays)
  260.        
  261.        4.) Copy  the  SAMPLE  LOCALNUM.1  from DATA.ZIP to your  \GAP\MAIN
  262.            directory,  (OR   whatever  directory   your  USERS.DAT  file
  263.            is located in.) It MUST be located there and you MUST edit it.
  264.        
  265.        5.)  Edit  the  LOCALNUM.1  file  to  include BOTH the AREA CODE and
  266.            PREFIX of the  numbers that will  be considered LOCAL  CALLS for
  267.            you.   The following  formats are  permitted for  EACH entry  in
  268.            LOCALNUM.1 : XXX-xxx  where XXX is  the AREA CODE  and xxx is  a
  269.            PREFIX WITHIN that  area code.   This is termed  a SINGLE PREFIX
  270.            number.
  271.        
  272.            Additionally you may RANGE numbers in the following format:
  273.            XXX-xxx:xxx
  274.        
  275.            In this above  example XXX is  the area code,  xxx:xxx represent
  276.            the FIRST  and LAST  _PREFIXES_ within  the range  that you will
  277.            consider  valid.   For  example:   402-421:441  indicates   that
  278.            numbers  between   402-421-xxxx  and   402-441-xxxx  are   valid
  279.            numbers.
  280.        
  281.            You  may  freely   intermix  both  RANGED   numbers  and  SINGLE
  282.            PREFIX numbers in the files.   BackFire will  expand the  ranged
  283.            numbers  as needed.
  284.        
  285.            As you can  see from the  sample file, Lincoln Nebraska is  area
  286.            code 402, the  numbers AFTER each  402 in the file are  PREFIXES
  287.            within 402 that  are LOCAL   to me.   The information   required
  288.            can generally  be   obtained from   your local   phone book   or
  289.            directly from the phone company.
  290.        
  291.        6.) Change to the  \GAP directory  and run  BFFIG.EXE to establish a
  292.            BACKFIRE.CNF configuration  file for  the node.   The fields  in
  293.            BFFIG.EXE  are  mostly  self   explanatory  with  a  couple   of
  294.            exceptions.
  295.        
  296.        7.) While still in the  \GAP directory you must run  the BFBUILD.EXE
  297.            program.    This  program   will  create   the  BFUSER.IDX   and
  298.            BFUSER.DAT files that contain  a record for each  user currently
  299.            on your system.  This step is ESSENTIAL before running  BackFire
  300.            for the first time.
  301.        
  302.  
  303.  
  304.  
  305.  
  306.        BackFire Version 3.05           8                     09-06-92        
  307.        [[ BFFIG STEP BY STEP ]]
  308.        
  309.        * WARNING *
  310.        
  311.          Since it is  possible for your  BackFire system to  be making LONG
  312.          DISTANCE  calls,  you  MUST  completely  understand  the   options
  313.          presented to you in BFFIG and how they effect operations.
  314.        
  315.          I assume NO responsibility for  the operation of your system!   It
  316.          is  _SOLEY_  YOUR  responsibility  to  determine  that BackFire is
  317.          operating in the manner you desire!
  318.        
  319.        ** BFFIG PANEL #1 **
  320.        
  321.        ╔══════════════════════[ General Configuration ]═════════════════════╗
  322.        ║                                                                    ║
  323.        ║      Name of your BBS: Flite-Line                                  ║
  324.        ║                                                                    ║
  325.        ║ Your First Name: Steve             Your Last Name: Cox             ║
  326.        ║                                                                    ║
  327.        ║   Enable Duplicate Number Checking (Y/N): Y                        ║
  328.        ║                                                                    ║
  329.        ║   Comport for this node: 2   Base I/O Address: 02F8   IRQ: 3       ║
  330.        ║                                                                    ║
  331.        ║          What is YOUR Sysop Security Level: SYSOP                  ║
  332.        ║                                                                    ║
  333.        ║         ENTRY SECLEVEL              UPGRADE LEVEL       NEW TIME   ║
  334.        ║ Entry Level #1: 10          Upgrade Level #1: 20         Time: 60  ║
  335.        ║ Entry Level #2:             Upgrade Level #2:            Time:     ║
  336.        ║ Entry Level #3:             Upgrade Level #3:            Time:     ║
  337.        ║ Entry Level #4:             Upgrade Level #4:            Time:     ║
  338.        ║ Entry Level #5              Upgrade Level #5:            Time:     ║
  339.        ╚════════════════════════════════════════════════════════════════════╝
  340.        
  341.          This is the FIRST configuration screen in BFFIG.  Here is how you
  342.          fill in the scree:
  343.        
  344.          FIELD 1, BBS NAME:
  345.                   Self-explanatory, enter your BBS name here.
  346.        
  347.          FILED 2, SYSOP FIRST Name:
  348.                   Your FIRST Name
  349.        
  350.          FILED 3, SYSOP Last Name:
  351.                   Your LAST Name.
  352.        
  353.          FIELD 4, ENABLE DUPLICATE NUMBER CHECKING (Y/N)
  354.                   This is an  important field.  By DEFAULT BackFire ENABLES
  355.                   duplicate number  checking.   This means  that users  who
  356.                   duplicate  a  phone  number  with  some other user on the
  357.                   system will be denied  verification until the problem  is
  358.                   resolved.
  359.        
  360.                   If you set this to 'N',then BackFire will IGNORE the fact
  361.                   that  a  user  duplicated  phone  numbers with some other
  362.                   user.   You  are  encouraged  to  ENABLE duplicate number
  363.                   checking.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.        BackFire Version 3.05           9                     09-06-92        
  370.          FIELD 5, COMPORT FOR THIS NODE
  371.                   This is the  comport number, from  1 to 8  that this node
  372.                   is running on.
  373.        
  374.          FIELD 6, BASE I/O ADDRESS
  375.                   The base i/o address for the comport listed in field  #5.
  376.                   This number _MUST_ be in hexadecimal.
  377.        
  378.          FIELD 7, IRQ:
  379.                   Interrupt number  for the  comport and  base i/o  address
  380.                   listed in fields 5 and 6.
  381.        
  382.          FIELD 8, What is YOUR Security Level:
  383.                   BackFire will recognize you as the sysop and allow you to
  384.                   do both local and on-line testing without affecting  your
  385.                   security level. Place security level here.
  386.        
  387.          FIELDS 9 thru 23:
  388.        
  389.                   BackFire permits  up to  5 levels  of verification.   The
  390.                   configuration program will  allow you to  put in up  to 5
  391.                   security  levels  that  the  user  is  permitted to ENTER
  392.                   BackFire  with  along  with  5  levels  that user will be
  393.                   UPGRADED to  IF they  pass.   There is  also a TIME field
  394.                   for each of the 5 level sets.  This is the time the  user
  395.                   will be given  when they return  to the BBS  IF they PASS
  396.                   verification.
  397.        
  398.        
  399.                   Only  the  FIRST  level  set  is  REQUIRED.  In the first
  400.                   level  set  place  the  security  level number that a NEW
  401.                   USER is given  when they first  log onto your  BBS.  Mine
  402.                   is 10.   In the  UPGRADE field  place the  security level
  403.                   number to which  you will UPGRADE  them if they  PASS the
  404.                   callback check, mine  is 20 and  in the TIME  field place
  405.                   the amount of time you want them to have if the PASS  the
  406.                   callback process.  If you do not wish to use the other  4
  407.                   level sets  at this  time simply  carriage return through
  408.                   them.
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.        BackFire Version 3.05           10                     09-06-92        
  433.        ** BFFIG PANEL #2 **
  434.        
  435.        ╔════════════════════[ Long Distance Parameters ]════════════════════╗
  436.        ║                                                                    ║
  437.        ║     Enable Long Distance Calling (Y/N): N                          ║
  438.        ║                                                                    ║
  439.        ║ Long Distance numbers are NORMALLY dialed by BackFire by prefixing ║
  440.        ║ a 1- to the number and then dialing it.  For example, a normal     ║
  441.        ║ Long Distance number would be dialed as 1-XXX-XXX-XXXX             ║
  442.        ║ Some special Long Distance carriers and services require a special ║
  443.        ║ prefix in front of the number instead of a 1-.  If you subscribe   ║
  444.        ║ to one of those services, then place your ACCESS CODE in the field ║
  445.        ║ below. This should include any dialing DELAY characters (commas)   ║
  446.        ║ to allow the service to be accessed. Example: 292342,,,            ║
  447.        ║                                                                    ║
  448.        ║ If you DO NOT SUBSCRIBE to one of these services then USE THE      ║
  449.        ║ DEFAULT of 1- in this field.                                       ║
  450.        ║                                                                    ║
  451.        ║ Enter ACCESS CODE required for LD Service: 1-                      ║
  452.        ║ Do you also want this code prefixed to LOCAL numbers (Y/N): N      ║
  453.        ╚════════════════════════════════════════════════════════════════════╝
  454.        
  455.          FIELD 1, ENABLE LONG DISTANCE CALLING (Y/N)
  456.                  If you answer 'Y' to this question then BackFire WILL make
  457.                   long distance  calls.   Any number  that is  NOT in  your
  458.                   LOCALNUM.1 file AND does NOT  appear in one of the  other
  459.                   number  type  support  files  will  be considered as LONG
  460.                   DISTANCE by BackFire and if this  flag is set to 'Y', the
  461.                   number WILL be dialed.  All long distance call backs  are
  462.                   programmed to DROP THE  CONNECTION after the user  either
  463.                   fails or passes the callback verification.
  464.        
  465.          FIELD 2, Enter any ACCESS CODE required for LD Service:
  466.                   It is  VERY important  that you  understand EXACTLY  what
  467.                   this  field  does  and  how  it  is used.  Normally, LONG
  468.                   DISTANCE calls require a 1-  to be prefixed to the  users
  469.                   phone number. When you first install BackFire, this field
  470.                   will default  to 1-.   Most of  the time  you would leave
  471.                   this  as  is.   There  are  some  types  of long distance
  472.                   services  however  that  require  some  type  of  special
  473.                   access code  to use  them.   These codes  usually replace
  474.                   the 1- in a long distance number.
  475.        
  476.                   You might for instance belong to a long distance  service
  477.                   that assigns  you an  access code  of 1234  to use  their
  478.                   service.   To  dial a  long  distance  number  using this
  479.                   service  you  might  dial:  1234-402-421-2434.   The 1234
  480.                   replaces the 1- used in normal long distance.
  481.        
  482.                   If you belong  to a Long  Distance service of  this type,
  483.                   enter  the  special  access  code  in  this  field.    If
  484.                   required  you  may  also  include  any  number  of COMMAS
  485.                   following the  digits to  introduce a  delay allowing the
  486.                   service to be  accessed.  Your  special access might  be:
  487.                   1234,,,.  In the above  example the number would then  be
  488.                   dialed by BackFire  as  1234,,,402-421-2434.   There is a
  489.                   three second  delay from  the time  1234 is  dialed until
  490.                   the area code, 402 is dialed.
  491.  
  492.  
  493.  
  494.  
  495.        BackFire Version 3.05           11                     09-06-92        
  496.                   Again, normally this  field will be  a 1-. Put  a SPECIAL
  497.                   access code  in the field  ONLY  if you  belong to one of
  498.                   these types of services.
  499.        
  500.         FIELD 3,  Do you also want this code prefixed to LOCAL numbers(Y/N)
  501.                   If you belong to a  special calling service you MAY  have
  502.                   the  option  of  using  for  LOCAL  calls as well as Long
  503.                   Distance calls.   If you  USE a  special access,  AND you
  504.                   are allowed to you use  that service to make LOCAL  calls
  505.                   then answer this field  'Y' and your special  access code
  506.                   will  be  prefixed  to  both  LOCAL  and  LONG   DISTANCE
  507.                   numbers. NORMALLY this field would be set to 'N'.
  508.        
  509.        7.)  The next three panels, Panels #3, #4 and #5 will be covered  in
  510.             the ADVANCED setup.  Carriage return through all the fields  in
  511.             these three panels and get to panel #6, GLOBAL PARAMETERS.   We
  512.             will come back to Panel #3, #4 and #5 later.
  513.        
  514.        
  515.        ** BFFIG PANEL #6 **
  516.        
  517.        ╔════════════════════════[ Global Parameters ]═══════════════════════╗
  518.        ║                                                                    ║
  519.        ║ Disconnect after a LOCAL call (Y/N): N                             ║
  520.        ║ Leave Modem Speaker ON during callback (Y/N): N                    ║
  521.        ║                                                                    ║
  522.        ║ If you have DISABLED Long Distance Callbacks the fields below tell ║
  523.        ║ BackFire how to handle Long Distance Callers. If you enter the word║
  524.        ║ SAME in the field below, the caller will be returned to GAP        ║
  525.        ║ with the same LEVEL with which they entered Backfire.  Any other   ║
  526.        ║ entry in this field is the SECLEVEL the Long Distance caller will  ║
  527.        ║ be given when they are returned to the BBS.  The time field is the ║
  528.        ║ time the user will be given when returned to the BBS.              ║
  529.        ║                                                                    ║
  530.        ║ Security LEVEL to give LD caller if LD Disabled:  20               ║
  531.        ║           TIME to give LD Caller if LD Disabled:  60               ║
  532.        ║                                                                    ║
  533.        ║                                                                    ║
  534.        ║                                                                    ║
  535.        ║                                                                    ║
  536.        ╚════════════════════════════════════════════════════════════════════╝
  537.        
  538.        
  539.              FIELD 1, Disconnect after a LOCAL call (Y/N): N
  540.                  Normally callers  are returned  left ON-LINE  and returned
  541.                  to  the  BBS  continue  with  their  call IF they pass the
  542.                  callback verification  process.   If you  wish to override
  543.                  this   default   and   disconnect   local   callers  after
  544.                  verification then set this flag to Y.
  545.        
  546.              FIELD 2,  Leave Modem Speaker ON during Callback (Y/N): N
  547.                  Normally the modem  speaker is turned  OFF.  It  is a good
  548.                  diagnostic aid when first installing to be able to  LISTEN
  549.                  to  the  outgoing   call  to  make   sure  the  modem   is
  550.                  functioning  properly.   To  leave  the  speaker ON during
  551.                  callbacks  only,  set  this  flag  to  'Y'.  After you are
  552.                  satisfied that  everything is  functioning correctly,  you
  553.                  can set this flag back to 'N' to disable the speaker.
  554.  
  555.  
  556.  
  557.  
  558.        BackFire Version 3.05           12                     09-06-92        
  559.              FIELD 3, Security Level to give LD Caller if LD Disabled:
  560.        
  561.                  In panel #2  you were asked  whether you wanted  to ENABLE
  562.                  or DISABLE LONG DISTANCE calling.
  563.        
  564.                  If you answered 'N', do NOT make Long Distance  Callbacks,
  565.                  then BackFire must  know how you want to handle LD callers
  566.                  who enter for verification.
  567.        
  568.                  This field  may have  several different  types of entries.
  569.                  If  you  enter  the  word  SAME  in this field and did NOT
  570.                  enable  LD  calls,  the  long  distance  caller  will   be
  571.                  returned to the BBS with  exactly the SAME  level as  they
  572.                  had when the ENTERED BackFire.
  573.        
  574.                  If  you  wish  them  to  be  returned to the BBS with some
  575.                  OTHER security level , type that level in this field.
  576.        
  577.                  If you DID  enable LONG DISTANCE  calling, place the  name
  578.                  of the default  level  that a  LONG  DISTANCE caller  will
  579.                  be given when they PASS the verification process.
  580.        
  581.         FIELD 4, TIME TO GIVE LD CALLERS IF LD DISABLED:
  582.                  If  Long  Distance  calling  has  been  DISABLED, the Long
  583.                  Distance  caller  will  be  returned  to  the BBS with the
  584.                  amount of time remaining that you specify here.
  585.        
  586.        8.)  When you entered the last field in panel #6, BackFire creates a
  587.             file called BACKFIRE.CNF in the default directory which on this
  588.             initial setup should have been in ?:\GAP
  589.        
  590.             This completes  configuration of  BackFire to  make LOCAL calls
  591.             and  standard  Long  Distance   calls,  IF  you  enabled   Long
  592.             Distance.
  593.        
  594.             We will NOW configure  GAP and create the  necessary batch
  595.             files to run BackFire.
  596.        
  597.             ** NOTE **
  598.             If  you  are  running  a  MULTIUSER version of BackFire, simply
  599.             COPY  the  BACKFIRE.CNF  created in your \GAP directory to your
  600.             other \GAPx node directories,  change to those directories  and
  601.             run BFFIG again  to make any  changes to comport  numbers, base
  602.             i/o and  irq that  may be  required for  that particular  node.
  603.             When making  these changes,  you MUST  carriage return  through
  604.             EACH field in EACH  panel to CONFIRM it's  value.  Do NOT  just
  605.             change a field  or two in  the first panel  then ESCAPE out  of
  606.             the program.  If you do that, the new data will NOT be saved.
  607.        
  608.        9.)  HOOKING IT UP TO GAP!!
  609.        
  610.            BackFire was designed to be run in one of several different
  611.            ways but the PREFERRED method  is to run  BackFire directly
  612.            from a NEW USER QUESTIONAIRE.  It CAN be run from a MAIN MENU
  613.            hook or even as a standard DOOR, but you'll find operation to
  614.            be smoothest when run from the questionaire.
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.        BackFire Version 3.05           13                     09-06-92        
  622.            Decide now what method you will use to run BackFire. I
  623.            _STRONGLY_ recommend that you use the Questionaire method and
  624.            that will be described first.
  625.        
  626.            ** RECOMMENDED WAY TO RUN BAKCFIRE **
  627.        
  628.            HOOKING UP TO THE NEW USER QUESTIONAIRE.
  629.        
  630.            1.) The FIRST step in hooking up is to create an entry in your
  631.                DOORS.DAT file for the name of the batch file that will
  632.                execute BackFire.
  633.        
  634.            2.) Go to the \GAP\GEN directory and with an ascii text editor
  635.                load the file DOORS.DAT.
  636.        
  637.            3.) With your editor, create a new entry in this file called
  638.                CBACK, it will look like this:
  639.        
  640.                CBACK 10 CBACK.BAT
  641.                  ^    ^    ^
  642.                  |    |    |------- BATCH FILE THAT WILL RUN BACKFIRE
  643.                  |    |
  644.                  |    ------------- NEW USERS SECURITY LEVEL
  645.                  ------------------ DOOR NAME
  646.        
  647.                Then entry must  be in this  format.  If  you are running  a
  648.                multinode system you MAY  have more than one  DOORS.DAT file
  649.                and they will  all have different  names.  This  entry would
  650.                then be  placed in  EVERY DOORx.DAT  file for  each node  on
  651.                which you want BackFire to run.  The example above  requires
  652.                that a  batch file  named CBACK.BAT  be in  EACH of your GAP
  653.                NODE DIRECTORIES.  If you  only have ONE node the  CBACK.BAT
  654.                goes in the ?:\GAP directory.
  655.        
  656.                ** IMPORTANT **
  657.        
  658.                The POSITION of  this entry is  important!  Count  down from
  659.                the TOP  your DOORS.DAT  file to  find out  what LINE NUMBER
  660.                the above entry was placed on.  This LINE NUMBER is used  by
  661.                the questionaire processor to actually RUN the door.
  662.        
  663.        
  664.             4.) In your \GAP directory, create a NEW FILE called  CBACK.BAT
  665.                that will  actually RUN  BackFire.   This file  will contain
  666.                ONE WORD and ONE WORD ONLY, that word is: BACKFIRE
  667.        
  668.                If you are running  multi-nodes a CBACK.BAT must  be created
  669.                in EACH of  your NODE directories  but its content  is still
  670.                the one word, BACKFIRE
  671.        
  672.            5.) Almost finished.  You must  now put a line in your  NEWQUEST
  673.                New User Questionaire that  will execute the CBACK.BAT  file
  674.                from the questionaire.
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.        BackFire Version 3.05           14                     09-06-92        
  685.                In your NEWQUEST file, at the exact point in the file  where
  686.                you  wish  the  callback  system  to  be  run,  insert   the
  687.                following:
  688.        
  689.                XDoor 11
  690.        
  691.                The  number  11  is  VARIABLE  and  it  is  the  LINE NUMBER
  692.                POSITION the CBACK entry in your DOORS.DAT file.  So if  the
  693.                CBACK entry in your DOORS.DAT file is on LINE NUMBER 4,  the
  694.                actual entry in NEWQUEST would be:
  695.        
  696.                Xdoor 4
  697.        
  698.                See how that works?  Now when a new user logs on, they  will
  699.                answer  whatever  questions  you  have  in  your  New   user
  700.                questionaire  and  when  it  comes  to  the  point  in   the
  701.                questionaire that  the Xdoor  x entry  appears the CBACK.BAT
  702.                file will be executed and  the user will find themselves  in
  703.                BackFire.
  704.        
  705.                BackFire is now ready for  use, but there is one  more thing
  706.                that you really should do.
  707.        
  708.            6.) For  a LOT  of reasons  users fail  callbacks.  Dup numbers,
  709.                can't figure  out how  to make  their modem answer, etc etc.
  710.                Because of  this you  need to  provide users  that fail  the
  711.                first  time  they  try  a  way  to  RERUN  BackFire  to  get
  712.                themselves verified.
  713.        
  714.                This is most easlily done by making a COPY of your  NEWQUEST
  715.                New User Questionaire and  calling it some other  name, such
  716.                as QUEST1 or QUEST2.   This Questionaire can then be  called
  717.                by a user from your  REGULAR questionaire menu and the  user
  718.                will be able to run  BackFire as many times as  necessary in
  719.                order to finally get  themselves verified.  In  your regular
  720.                Questionaire menu you would simply add an entry telling  the
  721.                user to  run this  questionaire to  reactivate the  callback
  722.                system.
  723.        
  724.                This  completes  the  hook  up  of  BackFire to your GAP 6.0
  725.                system.   Its  operation  should  be  clean and reliable and
  726.                provide  you  a  very  easy  way  of  dealing  with your new
  727.                callers.
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.        BackFire Version 3.05           15                     09-06-92        
  748.           * IMPORTANT NOTE *
  749.        
  750.            There is only TWO parameters that MAY be placed on the  BackFire
  751.            command  line  IF  you  need  one  of them.  By default BackFire
  752.            dials the  phone using  TONE dialing.   If for  some reason your
  753.            phone system needs PULSE dialing, place a P on the command  line
  754.            with  BackFire  ie:   BACKFIRE  P  and  dialing will be by PULSE
  755.            rather than TONE.
  756.        
  757.            Some  modems  are  VERY  slow  at  returning the CONNECT strings
  758.            after  the  carrier  is  detected,  OR  they  return up to three
  759.            strings  during  the  connection  sequence,  a CARRIER message a
  760.            PROTOCOL message and  CONNECT message.   Your SHOULD have  these
  761.            type modems  set to  return on  a single  CONNECT XXXXX  message
  762.            instead of  the default  three strings.   These modems  cause  a
  763.            timing problem with BackFire that  can be overcome by using  the
  764.            SLOW  swith  on  the  command  line.   If you use BACKFIRE SLOW,
  765.            BackFire  will  adjust  its  internal  timing  to compenaste for
  766.            these modems.
  767.        
  768.            Problems  with  SLOW  modems  will  USUALLY  show  up by callers
  769.            failing the  callback repeatedly.  Check your  BFLOG.x file  and
  770.            you will  see what  appear to  be MODEM  CONNECT MESSAGES in the
  771.            password field  in the  logs.   If you  see this  simpley enable
  772.            SLOW mode and it should take care of the problem.
  773.        
  774.        
  775.            Examples:  BACKFIRE P      (Dial pulse)
  776.                       BACKFIRE SLOW   (tone dialing slow timing mode)
  777.                       BACKFIRE P SLOW (slow mode with pulse dialing)
  778.        
  779.        Thats it! BackFire is ready to start verifying callers on your
  780.        system
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.        BackFire Version 3.05           16                     09-06-92        
  811.        [[ TESTING BACKFIRE FOR THE FIRST TIME ]]
  812.        
  813.        Unlike many other callback verification systems  available, BackFire
  814.        provides you with a LOCAL TESTING mode so that you can check to  see
  815.        that  things  are  working  correctly  and  to check out the display
  816.        screens you create or edit.
  817.        
  818.        To test BackFire simply  start GAP login locally   as the sysop.  Go
  819.        to the Questionaire menu and choose the questionaire you created  as
  820.        the  one  for  a  new  user  to  try verification again and BackFire
  821.        should come up flying!
  822.        
  823.        Since you  are logged  on  LOCALLY  BackFire  will  go  through  ALL
  824.        the steps of verifying you EXCEPT for the actual dial back.
  825.        
  826.        BackFire  knows  you as the  Sysop  whether  you  log  on locally OR
  827.        remotely and it will treat you differently than a regular user.   It
  828.        will go  through ALL  the steps  of a  call back verification EXCEPT
  829.        that it will NOT change your SECURITY LEVEL.
  830.        
  831.        If all the screens  come up the way  you want them you  are ready to
  832.        turn it loose and begin verifying callers.
  833.        
  834.        Pretty easy huh?
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.        BackFire Version 3.05           17                     09-06-92        
  874.        [[ ADVANCED SETUP ]]
  875.        
  876.        After following the  initial setup instructions  you can proceed  to
  877.        the more advanced features of BackFire.
  878.        
  879.        In  this  section  I  will  explain  the use of LONG DISTANCE, ZONE,
  880.        METRO and  REGION callback  setups. Understand  that the  CALL TYPES
  881.        described below are in BackFire's own  terminology.  The definitions
  882.        of call types and names are unique to this program.
  883.        
  884.        BackFire has  the ability  to perform ANY combination of these calls
  885.        automatically.  All you need to do  is set a flag or two a  create a
  886.        couple of simple format files.
  887.        
  888.        * EXPLANATION OF TERMS *
  889.        
  890.        METRO CALL:  This is a call  that is a TOLL CALL but is  NOT handled
  891.                     like a  regular long  distance call.   A metro  call is
  892.                     one that  you would  dial manually  by NOT  dialing the
  893.                     AREA CODE and by NOT placing a 1- or any other  special
  894.                     access code  in front  of the  number.   In other words
  895.                     you dial it just like it  was a LOCAL call but you  pay
  896.                     for it as if it were an LD call.
  897.        
  898.        ZONE CALL:  This  is a TOLL CALL  but is NOT handled  like a regular
  899.                    long distance call.  A  ZONE call is one that  you would
  900.                    dial manually by  NOT dialing the  AREA CODE but  you DO
  901.                    place a 1-  or some other  special access code  in front
  902.                    of  the  number.   In  other  words  the number would be
  903.                    dialed as 1-363-2914  (no area code).   You are  charged
  904.                    an LD rate for these calls.
  905.        
  906.        REGION CALL: This is a call that  is a LOCAL call but ALL digits  of
  907.                     the  users  number  including  the  area code are used.
  908.                     Normally  these  numbers  are  NOT  dialed  using an LD
  909.                     access  code.   This  type  of  call  would normally be
  910.                     dialed as 402-363-2914.  This type of call assumes  the
  911.                     are NOT BILLED  Long Distance rates  and that the  user
  912.                     may remain on-line after the verification.
  913.        
  914.        LONG DISTANCE: This is a call that is a TOLL call and ALL digits  of
  915.                       the  users  number  including  the  area code must be
  916.                       dialed AND prefixed with  a 1- or some  other special
  917.                       access code.   This type of  call would be  dialed as
  918.                       1-402-363-2914.  You are  charged LD rates for  these
  919.                       calls.
  920.        
  921.        LOCAL CALL:   This is a  call that is  NOT a toll  call and the user
  922.                     can  remain  on-line  to  you  after  the  callback  is
  923.                     complete.  The  area code is  NOT dialed and  no prefix
  924.                     is placed in  front of the  number.  An  example of how
  925.                     this number is dialed is: 421-2434.
  926.        
  927.        As you can  see, BackFire has the ability to make all FIVE  types of
  928.        calls for you if you permit it to do so.
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.        BackFire Version 3.05           18                     09-06-92        
  937.        You will  also note  as we  go through  BFFIG panels  #3, #4  and #5
  938.        that you have the  option of placing  OR NOT placing  the LD  access
  939.        code whether  special,   or  simply  1-   in  front of ANY  of these
  940.        five number types which  has the  effect  of allowing  10  different
  941.        callback setups that BackFire can  make. UNDERSTAND THE USE OF THESE
  942.        CALL TYPES COMPLETELY BEFORE USING THEM.
  943.        
  944.        ** MULTI-NODE OPERATORS TAKE SPECIAL NOTE OF THE FOLLOWING **
  945.        
  946.          Unlike many  other callback verification  systems, BackFire allows
  947.          NODE DEPENDENCY of the DATA FILES containing numbers that will  be
  948.          called back for verification.
  949.        
  950.          This is designed specifically for  sysops who have nodes that  are
  951.          NOT within the  same calling area  and require different  lists of
  952.          numbers for callback qualification.
  953.        
  954.          You might for example  have a TWO NODE  system, one of your  nodes
  955.          might be AREA 402, PREFIX 421 and the OTHER node might be in  AREA
  956.          402, PREFIX 533.  This is typically done by sysops in small  towns
  957.          who are  located close  to a  metropolitan area  but are  normally
  958.          long distance  calls for  those in  the larger  city.   Some phone
  959.          services will  allow you  to have  a direct  local line  from that
  960.          larger city so  that people calling  you from the  larger city may
  961.          do so  for a  local call  instead of  a long  distance call.   So,
  962.          anyone calling  on the  second node  or the  direct line  from the
  963.          larger city may be safely called back as a LOCAL call by that  one
  964.          node only.  If they called on  the OTHER node, it would be a  LONG
  965.          DISTANCE call.   By necessity  then, each  of the  two nodes  MUST
  966.          have DIFFERENT number lists because callers from certain  prefixes
  967.          are treated differently by the two nodes.
  968.        
  969.          Using LOCALNUM.1  as an  example.   This file  is read  by DEFAULT
  970.          when BackFire starts up on NODE  1.  If your second node  requires
  971.          a different list then simply make a LOCALNUM.2 file that  contains
  972.          the numbers that are considered local to IT!  You would then  have
  973.          a LOCALNUM.1 and a LOCALNUM.2 file in your  ?:\GAP\MAIN directory.
  974.          In this  situation when  BackFire is  started on  NODE 1,  it will
  975.          read  LOCALNUM.1,  when  it  is  started  on  NODE 2, it will read
  976.          LOCALNUM.2.
  977.        
  978.          This scheme is true for ALL number lists in  BackFire, ZONENUM0.x,
  979.          ZONENUM1.x, REGION.x and  so on.   The ONLY number  file that does
  980.          not honor  this format  is BADNUM.LST,  this file  is read  by ALL
  981.          nodes.
  982.        
  983.          If  you  have  multi-nodes  and  they  are  all  within  the  SAME
  984.          area/prefix  then  the  above  is  not  necessary.   All  that  is
  985.          required is the LOCALNUM.1 file.  When NODE 2 thru X startup  they
  986.          attempt to  locate any  NODE DEPENDENT  data files.   If none  are
  987.          present the node will use the files with .1 extension.
  988.        
  989.          Bear that in mind as  we proceed through the descriptions  of call
  990.          types  and  remember  that  when  I  refer  to  XXXXXXX.1, it also
  991.          applies to XXXXXXX.2 and so on.
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.        BackFire Version 3.05           19                     09-06-92        
  1000.        ** LOCAL CALLING ONLY **
  1001.        
  1002.        The simplest type of call of  course is LOCAL callbacks only.   This
  1003.        requires that the LOCALNUM.1 file be filled in with  areacode/prefix
  1004.        numbers  as  described  in  the  initial installation, AND the ALLOW
  1005.        LONG DISTANCE CALLBACK flag in BFFIG is set to N.
  1006.        
  1007.        In this case BackFire will ONLY  callback users  whose area code and
  1008.        prefix are found  in LOCALNUM.1.   If it is  NOT found in  that file
  1009.        then  it  is  assumed  that  the  user  is calling long distance and
  1010.        callback will be disallowed.
  1011.        
  1012.        You  DO  have  the  option  of  including the SPECIAL ACCESS code in
  1013.        front of LOCAL numbers if you desire, but NORMALLY you would NOT  do
  1014.        this.
  1015.        
  1016.        * ENABLING LONG DISTANCE CALLBACK *
  1017.        
  1018.        To enable long distance  callback verification simply run  BFFIG.EXE
  1019.        in EACH NODE and set the ALLOW LONG DISTANCE CALLBACK flag in  BFFIG
  1020.        PANEL #2 to Y.
  1021.        
  1022.        In this  case when BackFire scans the LOCALNUM.1  file and  does NOT
  1023.        find  the  users  area/prefix  in  the  list it will assume they are
  1024.        calling LD  and will  dial the  FULL number  including area code and
  1025.        will also  prefix the  number with  1- or  your special access code.
  1026.        Like this, 1-402-421-2434.
  1027.        
  1028.        When Long Distance  Callback IS enabled, BackFire will call the user
  1029.        back for verification.   When the callback  is complete,  regardless
  1030.        of  whether  the  user  PASSED  or  FAILED,  the  CONNECTION WILL BE
  1031.        DROPPED!,  the  user  will  NOT  be  returned  to  the BBS but their
  1032.        PROFILE WILL BE UPGRADED so that  the next time they call they  will
  1033.        have the new security level in effect.
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.        BackFire Version 3.05           20                     09-06-92        
  1063.        ** ENABLING METRO CALLING (0+zones) **
  1064.        
  1065.        ** BFFIG PANEL #3 **
  1066.        
  1067.        ╔═════════════════[ Metro Number Dialing Parameters ]════════════════╗
  1068.        ║                                                                    ║
  1069.        ║ Numbers in the ZONENUM0.1 file are  NORMALLY dialed like local     ║
  1070.        ║ numbers after stripping the AREA CODE out. If you wish to have     ║
  1071.        ║ the LD access code entered in PANEL #1 PREFIXED to the numbers     ║
  1072.        ║ in the ZONENUM0.1 file  before dialing  then answer 'Y' to the     ║
  1073.        ║ prompt below, otherwise answer 'N'. Normally this should be 'N'    ║
  1074.        ║                                                                    ║
  1075.        ║ If you answer 'Y' to prompt , the Long distance Access Code will   ║
  1076.        ║ be PREFIXED to the number, if you answer 'N' then NOTHING will be  ║
  1077.        ║ prefixed to the number.  In both cases, the AREA CODE is stripped  ║
  1078.        ║ out of the number.                                                 ║
  1079.        ║                                                                    ║
  1080.        ║ Example WITH LD ACCESS CODE:  1234,,,XXX-XXXX                      ║
  1081.        ║ Example WITHOUT LD ACCESS CODE:  XXX-XXXX [DEFAULT]                ║
  1082.        ║                                                                    ║
  1083.        ║ PREFIX ACCESS CODE to ZONENUM0.1 numbers (Y/N):  N                 ║
  1084.        ║                                                                    ║
  1085.        ╚════════════════════════════════════════════════════════════════════╝
  1086.        
  1087.        The FIRST  thing you  MUST understand  is that  the METRO  call is a
  1088.        TOLL or  LONG DISTANCE  call and  YOU will  be paying  for the call!
  1089.        METRO  calls  are  _NOT_  controlled  by  the  LD FLAG in BFFIG.EXE.
  1090.        Instead  they  are  controlled  by  the  PRESENCE of a filled called
  1091.        ZONENUM0.1 in your \GAP\MAIN directory.(or whichever directory  your
  1092.        LOCALNUM.1 file is located.)
  1093.        
  1094.        To  USE  METRO  calling,  create a  file in your \GAP\MAIN directory
  1095.        named ZONENUM0.1 Normally this is in your \GAP\MAIN directory but if
  1096.        your  directory  structure  is  different,  place this file wherever
  1097.        your USERS.DAT and LOCALNUM.1 files are located.
  1098.        
  1099.        This file's entries are in EXACTLY the same format as LOCALNUM.1 but
  1100.        the AREA/PREFIX's contained here are  for calls that will have  AREA
  1101.        CODES  REMOVED  before  dialing  AND  will  NOT have a 1- or special
  1102.        access code prefixed to the number so the NORMAL answer to field  #1
  1103.        in this panel is 'N', do NOT prefix the number with the LD code.
  1104.        
  1105.        You are however  able with FIELD  1 in BFFIG  PANEL #3 to  choose to
  1106.        have the SPECIAL ACCESS CODE prefixed to these numbers.
  1107.        
  1108.        For example:  The  user calls with a  phone of 402-499-2121.   First
  1109.        action by BackFire is to scan LOCALNUM.1    If 402-499 is  not found
  1110.        there it will then  see if ZONENUM0.1 exists.   If it DOES exist  in
  1111.        ZONENUM0.1 then the number will be  dialed as 499-2121.  As you  can
  1112.        see, the area  is code is  removed and NO  1- is placed  in front of
  1113.        the resultant number.
  1114.        
  1115.        ** NOTE THIS CAREFULLY **
  1116.        Since this is  a TOLL CALL,  the connection WILL  BE DROPPED whether
  1117.        the user PASSES or FAILS  the callback verification but the  upgrade
  1118.        takes place and when they call back they will be at the new  PROFILE
  1119.        level.  If  the  AREA/PREFIX  DOES  exist  in  ZONENUM0.1 it WILL be
  1120.        dialed REGARDLESS of  the setting of  ENABLE LONG DISTANCE  CALLBACK
  1121.        in BFFIG.EXE
  1122.  
  1123.  
  1124.  
  1125.        BackFire Version 3.05           21                     09-06-92        
  1126.        ** ENABLING ZONE CALLING * (1+zones) **
  1127.        
  1128.        ** BFFIG PANEL #4 **
  1129.        
  1130.        ╔═════════════════[ Zone Number Dialing Parameters ]═════════════════╗
  1131.        ║                                                                    ║
  1132.        ║ Numbers in the ZONENUM1.1 file  are NORMALLY  dialed like Long     ║
  1133.        ║ Distance numbers after stripping the AREA CODE out and placing     ║
  1134.        ║ an LD Access Code in front of the number. Example 1-XXX-XXXX       ║
  1135.        ║ If you wish to have the LD ACCESS CODE in Panel #1 PREFIXED        ║
  1136.        ║ to the numbers in the ZONENUM1.1  file  before dialing then answer ║
  1137.        ║ 'Y' to the prompt below, otherwise answer 'N'. NORMALLY 'Y'        ║
  1138.        ║                                                                    ║
  1139.        ║ If you answer 'Y' to prompt below, Long Distance Access Code will  ║
  1140.        ║ be PREFIXED to the number, if you answer 'N' then NOTHING will be  ║
  1141.        ║ prefixed to the number.  In both cases, the AREA CODE is stripped  ║
  1142.        ║ out of the number.                                                 ║
  1143.        ║                                                                    ║
  1144.        ║    Example WITH LD ACCESS CODE: 1-XXX-XXXX  [DEFAULT]              ║
  1145.        ║ Example WITHOUT LD ACCESS CODE: XXX-XXXX                           ║
  1146.        ║                                                                    ║
  1147.        ║ PREFIX ACCESS CODE to ZONENUM1.1 numbers (Y/N): Y                  ║
  1148.        ╚════════════════════════════════════════════════════════════════════╝
  1149.        
  1150.        As with METRO  calls you MUST  understand is that  the ZONE call is
  1151.        also a TOLL or  LONG DISTANCE calls and  YOU will be paying for the
  1152.        call!  ZONE calls are _NOT_ controlled by the LD FLAG in  BFFIG.EXE.
  1153.        Instead  they  are  controlled  by  the  PRESENCE of a file  called
  1154.        ZONENUM1.1 in your \GAP\MAIN directory.
  1155.        
  1156.        To USE ZONE calling, create a file in the \GAP\MAIN directory named
  1157.        ZONENUM1.1  This   file  must   be  in  whichever  directory   your
  1158.        USERS.DAT  and  LOCALNUM.1  file  if  you  do not use the standard
  1159.        GAP directory structure.
  1160.        
  1161.        This file  listings in  EXACTLY the  same format  as LOCALNUM.1  and
  1162.        ZONENUM0.1 but the AREA/PREFIX's  contained here are for  calls that
  1163.        will have AREA  CODE REMOVED before  dialing AND WILL  have a 1-  or
  1164.        other special access code prefixed to the number.
  1165.        
  1166.        For example:  The  user calls with a  phone of 402-499-2121.   First
  1167.        action by  BackFire is  to scan  LOCALNUM.1 If  402-499 is not found
  1168.        there it will then  see if ZONENUM0.1 exists.   If it DOES exist  in
  1169.        ZONENUM0.1 then it is treated as a METRO call as described above.
  1170.        
  1171.        If the number is NOT  FOUND in either LOCALNUM.1 or  ZONENUM0.1 then
  1172.        BackFire  will  check  for  the  PRESENCE  of ZONENUM1.1 If the file
  1173.        exists  it  will  be  opened  and  scanned for the users AREA/PREFIX
  1174.        combination.   If the  AREA/PREFIX IS  found in  ZONENUM1.1 then the
  1175.        number normally would be dialed as 1-499-2121.
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.        BackFire Version 3.05           22                     09-06-92        
  1189.        As you can see, the area is code is removed and 1- or other special
  1190.        access code is NORMALLY placed in front of the resultant number.
  1191.        
  1192.        Using FIELD 1  in BFFIG PANEL  #4 you may  optionally choose NOT  to
  1193.        prefix  the  number  with  the  1-  or  special  access code but the
  1194.        default of 'Y' is NORMALLY what you would use.
  1195.        
  1196.        Since this is  a TOLL CALL,  the connection WILL  BE DROPPED whether
  1197.        the user PASSES or FAILS  the callback verification but the  upgrade
  1198.        takes place and when they call back they will be at the new  PROFILE
  1199.        level.
  1200.        
  1201.        ** ENABLING REGION CALLING **
  1202.        
  1203.        * BFFIG PANEL #5 *
  1204.        
  1205.        ╔═══════════════[ Regional Number Dialing Parameters ]═══════════════╗
  1206.        ║                                                                    ║
  1207.        ║ Numbers in the REGION.1 file are  NORMALLY dialed  like Long       ║
  1208.        ║ Distance numbers, ie: 1-XXX-XXX-XXXX BUT are considered to be      ║
  1209.        ║ LOCAL CALLS. The user by default, remains ON-LINE.                 ║
  1210.        ║                                                                    ║
  1211.        ║ If you wish to have the LD ACCESS CODE entered in Panel #1         ║
  1212.        ║ prefixed to numbers in REGION.1 'Y' to  the  prompt below          ║
  1213.        ║ otherwise answer 'N' and NOTHING will be prefixed to the number    ║
  1214.        ║ In BOTH  cases, the area code REMAINS in the number, it is NOT     ║
  1215.        ║ stripped out of the number. Normally this field should be 'Y'      ║
  1216.        ║                                                                    ║
  1217.        ║    Example WITH LD ACCESS CODE: 1-XXX-XXX-XXXX  [DEFAULT]          ║
  1218.        ║ Example WITHOUT LD ACCESS CODE: XXX-XXX-XXXX                       ║
  1219.        ║                                                                    ║
  1220.        ║ PREFIX ACCESS CODE to REGION.1 numbers (Y/N): Y                    ║
  1221.        ║ DROP CONNECTION after callback from THIS file (Y/N): N             ║
  1222.        ║                                                                    ║
  1223.        ╚════════════════════════════════════════════════════════════════════╝
  1224.        
  1225.        The REGION  call is  an unusual,  'catch all'  type of  call and you
  1226.        must understand completely  what it is  designed to do  before using
  1227.        it.
  1228.        
  1229.        As with most  of the other  call types that  BackFire can make,  the
  1230.        REGION call is controlled by the PRESENCE of a file.  This files  is
  1231.        named REGION.1 This file should be placed in the \GAP\MAIN directory
  1232.        or wherever your USERS.DAT and LOCALNUM.1 files are located.
  1233.        
  1234.        The format of entries in REGION.1  are exactly the same as they  are
  1235.        for the other files and  numbers contained in REGION.1 are  NORMALLY
  1236.        TREATED AS LOCAL - TOLL FREE  CALLS but are DIALED IN LONG  DISTANCE
  1237.        FORMAT.
  1238.        
  1239.        Since these calls are NORMALLY  treated as LOCAL, the user  _WILL BY
  1240.        DEFAULT, REMAIN  ON-LINE AFTER  THE VERIFICATION_,  you may  however
  1241.        DISABLE this and DROP the connection on the user.  Understand  this!
  1242.        If you  MISUSE this  file you  could potentially  be calling  a user
  1243.        back LONG  DISTANCE AND  ALLOWING THEM  TO REMAIN  ON-LINE on _YOUR_
  1244.        TOLL!
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.        BackFire Version 3.05           23                     09-06-92        
  1252.        FIELD 1 in BFFIG  PANEL #5 allows you  to specify whether the  1- or
  1253.        special  access  should  or  should  not  be  prefixed to numbers in
  1254.        REGION.1  Normally you would put 'Y' in this field.
  1255.        
  1256.        FIELD 2  in BFFIG  PANEL #5  allows you  specify whether  the caller
  1257.        should  be  DROPPED  or   NOT  DROPPED  after  successful   callback
  1258.        verification.  Default  is NO, the  user BY DEFAULT  remains ON-LINE
  1259.        with this type of call.
  1260.        
  1261.        
  1262.        ** SUMMARY OF CALLING TYPES **
  1263.        
  1264.        As you can see, BackFire is EXTREMELY flexible in it's design. Using
  1265.        the methods  above you  can configure  BackFire to do just about any
  1266.        type of callback you can dream up.
  1267.        
  1268.        You may enable features in  ANY combination of settings.   You might
  1269.        for  instance  want  to  DISALLOW  FULL  long distance callbacks but
  1270.        ALLOW ZONE and METRO calls.  Simply turn OFF the ALLOW LD  CALLBACKS
  1271.        flag in  BFFIG, create  the ZONENUM0.1  and ZONENUM1.1  and this  is
  1272.        exactly what will happen.
  1273.        
  1274.        You may want  to allow ONLY  LOCAL callbacks. If  so, do NOT  create
  1275.        ZONENUM0.1 and  ZONENUM1.1 and  set the  ALLOW LD  CALLBACKS flag in
  1276.        BFFIG to N.
  1277.        
  1278.        You may not want to use ZONE  and METRO but you DO want to  allow LD
  1279.        callbacks.  Simple  set ALLOW LD  CALLBACKS to Y  and do NOT  create
  1280.        ZONENUM0.1 and ZONENUM1.1.
  1281.        
  1282.        You may  want to  ALLOW METRO  and DISALLOW  ZONE calls,  create the
  1283.        ZONENUM0.1  and  do  NOT  create  the  ZONENUM1.1  file  and that is
  1284.        exactly what will happen.
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.        BackFire Version 3.05           24                     09-06-92        
  1315.        [[ OTHER PROGRAMS AND THEIR USE ]]
  1316.        
  1317.        BFFIG.EXE is of course  the CONFIGURATION program used  to configure
  1318.        the  node  for  callback  operation.   This  program  creates a file
  1319.        called BACKFIRE.CNF  in the  directory you  are in  when you run it.
  1320.        This _MUST_ be each of your \GAPx NODE directories.
  1321.        
  1322.        If you are  running a single  node system then  BFFIG.EXE only needs
  1323.        to be run in the \GAP directory.  If you are running MULTI node,  you
  1324.        must  run  BFFIG.EXE  in  EACH  \GAPx  NODE  directory to establish a
  1325.        BACKFIRE.CNF for each node.
  1326.        
  1327.        BFFIG may be run at ANY time to change configurations.
  1328.        
  1329.        
  1330.        BFBUILD.EXE is a program that constructs and updates the  BFUSER.DAT
  1331.        and  BFUSER.IDX  files  located  in  your \GAP\MAIN directory. These
  1332.        files are used  by BackFire to  check for duplicate  numbers entered
  1333.        by callers.
  1334.        
  1335.        When run, BFBUILD reads the  USERS.DAT file and places a  record for
  1336.        each user in your GAP user  files into this BFUSER.DAT file. When  a
  1337.        new user  logs on  and enters  BackFire, the  numbers they enter are
  1338.        checked   against   this   file   for   validity  and  appropriately
  1339.        controlled.
  1340.        
  1341.        You  may  run  BFBUILD  at  any  time  to  keep your BFUSER and your
  1342.        USERS.DAT  file  in  sync.   If  you  wish to completely freshen the
  1343.        BFUSER file, simply DELETE BFUSER.DAT, BFUSER.IDX and BFLOK.DAT,  CD
  1344.        to the \GAP directory and run BFBUILD.  A new file set that is  100%
  1345.        in sync with your USERS.DAT will be created.
  1346.        
  1347.        BFSYNC.EXE  is  the  program  that  syncronizes your BFUSER.DAT file
  1348.        with your GAP USERS.DAT file.  This program should be run EACH  TIME
  1349.        that you run GAPPACK to delete  old user records.  BFSYNC will  make
  1350.        sure that  the user  is ALSO  deleted from  BFUSER.DAT file.  BFSYNC
  1351.        may be run in an EVENT if you wish to do so.
  1352.        
  1353.        
  1354.        * NOTE *
  1355.        
  1356.        BFBUILD.EXE  ,BFFIG.EXE   and  BFSYNC.EXE   are  NOT   a  multi-user
  1357.        programs.  All nodes MUST  be   off-line  when  running  them   or a
  1358.        sharing violation will occur.
  1359.        
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.        BackFire Version 3.05           25                     09-06-92        
  1378.        [[ OTHER DATA FILES AND THEIR USE ]]
  1379.        
  1380.        You may create a file called BADNUM.LST in your \GAP\MAIN
  1381.        directory for BackFire to use in checking for bad numbers.
  1382.        
  1383.        Numbers such as 000-000-0000 and 911-911-9111 should be blocked  and
  1384.        the user penalized for trying to use them.
  1385.        
  1386.        BackFire AUTOMATICALLY checks  for 800, 900,  911, 976, 411  and 611
  1387.        and gets  rather nasty  with the  caller if  it finds these numbers.
  1388.        If you wish to check any other numbers place them in BADNUM.LST.
  1389.        
  1390.        BFLOG.x
  1391.        
  1392.        These are log files of BackFire's  activities.   They are created in
  1393.        your \GAP\MAIN directory,  the .x is the node number.   The  log for
  1394.        NODE 1 callback activities is  BFLOG.1 and BFLOG.2 for node  two and
  1395.        so on.
  1396.        
  1397.        You may delete these  files at any time  and they will be  recreated
  1398.        as needed.   They will  grow quite rapidly because BackFire keeps  a
  1399.        COMPLETE log of the callback sequence.
  1400.        
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.        BackFire Version 3.05           26                     09-06-92        
  1441.        
  1442.        Thats  really  all  there  is  to  running  BackFire.   It's simple,
  1443.        reliable, flexible and fast!
  1444.        
  1445.        As  with  our  other  products  you  can  look  forward  to support,
  1446.        enhancements and upgrades,  with a firm  commitment from me to keep
  1447.        the BackFire system up to date and fully compatible with GAP.
  1448.        
  1449.        Enjoy BackFire, it's been fun bringing it to you!
  1450.        
  1451.        For the latest versions of Live Systems Shareware, including
  1452.        BackFire and WildFire, call FLITE-LINE at: 402-421-9610 V.32
  1453.        
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.        BackFire Version 3.05           27                     09-06-92        
  1504.        
  1505.        
  1506.                              [[ BACKFIRE REGISTRATION ]]
  1507.                             ~~~~~~~~~~~~~~~~~~~~~~~~
  1508.                          Live Systems Registration Form
  1509.        
  1510.        
  1511.         Name : _____________________________________________________
  1512.        
  1513.         Address : __________________________________________________
  1514.        
  1515.         Address : __________________________________________________
  1516.        
  1517.         City,State,Zip : ___________________________________________
  1518.        
  1519.         Voice Phone : ______________________________________________
  1520.        
  1521.         BBS Name: __________________________________________________
  1522.        
  1523.         BBS Number: ________________________________________________
  1524.        
  1525.         Comments: --------------------------------------------------
  1526.            --------------------------------------------------
  1527.            --------------------------------------------------
  1528.        
  1529.        
  1530.          Live Systems product you wish to register from the price list:
  1531.        
  1532.          CHECK ONE:
  1533.        
  1534.         [ ]  BackFire 3.05 Multi User version (unlimited)       25.00
  1535.        
  1536.         [ ]  BackFire 3.05 Single User version                  20.00
  1537.        
  1538.        
  1539.          MEDIA DESIRED:       [ ] 5 1/4 360k           [ ] 3 1/2 720k
  1540.        
  1541.                            Allow 2-3 Weeks for Delivery
  1542.        
  1543.         ------------------------------------------------------------
  1544.          Payment may be made by check or money order
  1545.         ------------------------------------------------------------
  1546.        
  1547.              Steve Cox
  1548.              Live Systems
  1549.              3800 Old Cheney Road
  1550.              Suite 101-133
  1551.               Lincoln, Ne.  68516
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.        BackFire Version 3.05           28                     09-06-92